Os desenvolvedores podem aproveitar o Windows e o Linux ao mesmo tempo em um computador Windows. O WSL (Subsistema do Windows para Linux) permite que os desenvolvedores instalem uma distribui莽茫o do Linux (como Ubuntu, OpenSUSE, Kali, Debian, Arch Linux etc) e usem aplicativos, utilit谩rios e ferramentas de linha de comando bash do Linux diretamente no Windows, sem modifica莽茫o, sem a sobrecarga de uma m谩quina virtual tradicional ou configura莽茫o dualboot.

Voc锚 deve estar executando o Windows 10 vers茫o 2004 e superior (Build 19041 e superior) ou o Windows 11 para usar os comandos abaixo. Se voc锚 estiver em vers玫es anteriores, consulte a p谩gina de instala莽茫o manual.

Agora voc锚 pode instalar tudo o que precisa para executar o WSL com apenas um comando. Abra o PowerShell ou o Prompt de Comando do Windows no modo de administrador clicando com o bot茫o direito do mouse e selecionando "Executar como administrador"; insira o comando wsl --install e reinicie o computador.

Esse comando habilitar谩 os recursos necess谩rios para executar o WSL e instalar a distribui莽茫o Ubuntu do Linux. (Essa distribui莽茫o padr茫o pode ser alterada.)

Se voc锚 estiver executando um build mais antigo ou simplesmente prefere n茫o usar o comando para instalar e quer instru莽玫es passo a passo, confira Etapas de instala莽茫o manual do WSL para vers玫es mais antigas .

Na primeira vez que voc锚 iniciar uma distribui莽茫o do Linux rec茅m-instalada, uma janela de console ser谩 aberta e ser谩 solicitado que voc锚 aguarde para que os arquivos sejam descompactados e armazenados em seu computador. Todas as futuras inicializa莽玫es dever茫o levar menos de um segundo.

Observa莽茫o

O comando acima s贸 funcionar谩 se o WSL n茫o estiver instalado; se voc锚 executar wsl --install e vir o texto de ajuda do WSL, tente executar wsl --list --online para ver a lista de distribui莽玫es dispon铆veis e execute wsl --install -d para instalar uma distribui莽茫o. Para desinstalar o WSL, confira Desinstalar a vers茫o herdada do WSL ou Cancelar o registro ou fazer a desinstala莽茫o de uma distribui莽茫o do Linux.

Por padr茫o, a distribui莽茫o do Linux instalada ser谩 o Ubuntu. Isso pode ser alterado usando o sinalizador -d.

Dica

Se voc锚 quiser instalar distribui莽玫es adicionais usando uma linha de comando Linux/Bash (em vez do PowerShell ou prompt de comando), dever谩 usar .exe no comando: wsl.exe --install -d ou, para listar as distribui莽玫es dispon铆veis: wsl.exe -l -o.

Se voc锚 encontrar um problema durante o processo de instala莽茫o, verifique a se莽茫o de instala莽茫o do guia de solu莽茫o de problemas.

Para instalar uma distribui莽茫o do Linux que n茫o esteja listada como dispon铆vel, voc锚 pode importar qualquer distribui莽茫o do Linux usando um arquivo TAR. Ou, em alguns casos, como no Arch Linux, voc锚 pode fazer a instala莽茫o usando um arquivo .appx. Voc锚 tamb茅m pode criar sua distribui莽茫o personalizada do Linux a ser usada com o WSL.

Depois de instalar o WSL, voc锚 precisar谩 criar uma conta de usu谩rio e uma senha para a distribui莽茫o do Linux rec茅m-instalada. Confira o guia Melhores pr谩ticas para configurar um ambiente de desenvolvimento do WSL para mais informa莽玫es.

Recomendamos seguir nosso guia Melhores pr谩ticas para configurar um ambiente de desenvolvimento do WSL para ver um passo a passo de como configurar um nome de usu谩rio e uma senha para suas distribui莽玫es do Linux instaladas, usar comandos do WSL b谩sicos, instalar e personalizar o Terminal do Windows, configurar para o controle de vers茫o do Git, editar e depurar c贸digo usando o servidor remoto do VS Code, conhecer boas pr谩ticas para armazenamento de arquivos, configurar um banco de dados, montar uma unidade externa, configurar a acelera莽茫o de GPU e muito mais.

Voc锚 pode listar suas distribui莽玫es do Linux instaladas e verificar a vers茫o do WSL para a qual cada uma est谩 definida inserindo o comando: wsl -l -v no PowerShell ou Prompt de Comando do Windows.

Para definir a vers茫o padr茫o como WSL 1 ou WSL 2 quando uma nova distribui莽茫o do Linux 茅 instalada, use o comando: wsl --set-default-version , substituindo por 1 ou 2.

Para definir a distribui莽茫o padr茫o do Linux usada com o comando wsl, insira wsl -s ou wsl --setdefault , substituindo pelo nome da distribui莽茫o do Linux que voc锚 gostaria de usar. Por exemplo, do PowerShell/CMD, insira: wsl -s Debian para definir a distribui莽茫o padr茫o como Debian. Agora, executar wsl npm init no PowerShell executar谩 o comando npm init no Debian.

Para executar uma distribui莽茫o espec铆fica do WSL no PowerShell ou no Prompt de Comando do Windows sem alterar sua distribui莽茫o padr茫o, use o comando: wsl -d , substituindo pelo nome da distribui莽茫o que voc锚 deseja usar.

Saiba mais no guia de Comandos b谩sicos para WSL.

As novas instala莽玫es do Linux, instaladas usando o comando wsl --install, ser茫o definidas como WSL 2 por padr茫o.

O comando wsl --set-version pode ser usado para fazer downgrade do WSL 2 para o WSL 1 ou atualizar as distribui莽玫es do Linux instaladas anteriormente do WSL 1 para o WSL 2.

Para ver se a distribui莽茫o do Linux est谩 definida como WSL 1 ou WSL 2, use o comando: wsl -l -v.

Para mudar de vers茫o, use o comando: wsl --set-version 2 substituindo pelo nome da distribui莽茫o do Linux que voc锚 quer atualizar. Por exemplo, wsl --set-version Ubuntu-20.04 2 definir谩 sua distribui莽茫o do Ubuntu 20.04 para usar o WSL 2.

Se voc锚 instalou o WSL manualmente antes da disponibiliza莽茫o do comando wsl --install, poder谩 ser necess谩rio habilitar o componente opcional de m谩quina virtual usado pelo WSL 2 e instalar o pacote do kernel, se isso ainda n茫o foi feito.

Para saber mais, confira Refer锚ncia de comando para WSL para obter uma lista de comandos do WSL, Comparar WSL 1 e WSL 2 para obter diretrizes sobre qual deles usar para seu cen谩rio de trabalho ou Pr谩ticas recomendadas para configurar um ambiente de desenvolvimento do WSL para obter diretrizes gerais sobre como configurar um bom fluxo de trabalho de desenvolvimento com o WSL.

O WSL d谩 suporte 脿 execu莽茫o de quantas distribui莽玫es do Linux diferentes voc锚 gostaria de instalar. Isso pode incluir a escolha de distribui莽玫es da Microsoft Store, a importa莽茫o de uma distribui莽茫o personalizada ou a cria莽茫o da sua distribui莽茫o personalizada.

H谩 v谩rias maneiras de executar suas distribui莽玫es do Linux depois de instaladas:

O m茅todo selecionado deve depender do que voc锚 est谩 fazendo. Se voc锚 abriu uma linha de comando do WSL dentro de uma janela do PowerShell ou Prompt do Windows e quer sair, insira o comando: exit.

Experimente os recursos ou atualiza莽玫es mais recentes do WSL participando do Programa Windows Insider. Depois de ingressar no Windows Insider, voc锚 pode escolher o canal do qual gostaria de receber compila莽玫es de pr茅-visualiza莽茫o no menu de configura莽玫es do Windows para receber automaticamente todas as atualiza莽玫es ou recursos de vers茫o pr茅via do WSL associados a esse build. Voc锚 pode escolher: